<script>
  /*
      小程序订阅消息能力

          https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/operation/private-account/subscription-message/subscribe-message
  */

  /*
      一、能力介绍

                于抖音App内外的双重交互，平台为小程序提供了通知信息强触达用户的能力，即订阅消息。

                通知消息不支持在侧边栏通知消息中展示，部分消息还支持进阶的 push 推送、feed提醒等能力。

                使用订阅消息能力可以打打提高消息触达效率，逐步培养用户复访意识。
  */

   /*
      二、能力价值

                 1、触达用户的高效方式：

                          订阅消息通过文字消息、图文消息等多种消息样式出现在用户不同的操作场景，让用户在必要时及时获取小程序内最新消息；

                          配合着消息的紧急程度该能力会适配不同的通知渠道：   

                                通知消息 + 实时提醒或信息流通知，消息渠道的有机结合可以让订阅消息做到合理高效的信息传达。

                 2、用户复访的稳定渠道：

                          消息通知作为小程序开发者与抖音用户进行沟通交流的重要方式，可以快速将内容和变化传达给用户以便用户及时做出反应；

                          当用户有流失去倾向时，订阅消息作为召回用户复访的稳定入口可以支持开发者灵活使用，

                          通过优质内容、福利活动等形式吸引用户再次访问小程序。
   */

   /*
      三、使用场景

                          场景介绍                                                适用的消息类型                                      场景示例
                          
                      1、在抖音App中侧边栏中，会聚合展示所有的通知消息，            支持所有的 "一次性订阅消息" + "长期订阅消息"           https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1a4fb54b79f44fcdadf9f369c41f2677~tplv-goo7wpa0wc-quality:q75.awebp
                         展示内容包括 "小程序头像+名称+订阅消息标题+
                         订阅消息关键词" 和具体通知内容，用户在接收消息后                                                               https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d1d906a1200241dbba0aa43b1874f6ee~tplv-goo7wpa0wc-quality:q75.awebp
                         可以点击消息概览查看具体消息内容，
                         点击消息具体内容可以前往小程序通知页面。


                      2、★、段内横幅： 当用户正在使用抖音App，消息回在抖音         支持部分一次性订阅消息 (选择的消息模板需符合规范)       https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/29bc9bbc8b764518a339bfb7943be929~tplv-goo7wpa0wc-quality:q75.awebp
                               App当前使用页面顶部以横幅西宁市展示，展示内容
                               包含 "小程序头像+名称+订阅消息标题"，用户
                               在接收消息后可在抖音App中的任一使用场景中                                                               https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/26dc5494fea7485a9ff1015694bb93b6~tplv-goo7wpa0wc-quality:q75.awebp
                               前往小程序通知页面。

                         ★、端外push： 当用户未打开抖音App，消息将推送至用户
                               移动设备主页展示在APP通知栏处，展示内容包含
                               "小程序头像+订阅消息标题+固定的消息通知文案"，
                               用户在接收消息后可直接点击唤起APP前往小程序
                               通知页面。


                      3、当用户正在使用抖音App，消息会在抖音App首页推荐信息流      支持部分长期订阅消息(选择的消息模板符合规范)             https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d4dde10b650d4b15933be4f0cdc2c0c5~tplv-goo7wpa0wc-quality:q75.awebp
                          中以异形卡的形式展示，展示内容是图文版本的通知消息，
                          当出现多个订阅异形卡时会聚合展示且自动轮播，
                          用户在刷到订阅异形卡时可以直接点击前往小程序通知页面。                                                        https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b241f7c4acaf488eaa51872de074bfb0~tplv-goo7wpa0wc-quality:q75.awebp
   */

    /*
        四、模板介绍

                        订阅消息是由 "消息模板" 和 "消息内容"组成，消息模板用固定文案来定义消息内容结构。

                        消息模板分为 "模板标题" 和 "模板关键词"，模板标题用来呈现消息结果状态，

                        模板关键词用来呈现消息内容维度。

                        ★、例如：

                              模板标题：  订单支付成功通知

                              关键词：    订单号、商品名称、支付金额、支付成功时间


                                  订阅消息的组成结构示意图：

                                      https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/092d933f8e63464188300a6804f8568f~tplv-goo7wpa0wc-quality:q75.awebp


                                   一通知消息中展示的消息微粒，用户可以看到以下内容：

                                      ①、小程序头像、名称、

                                      ②、订阅消息管理入口： 支持用户对消息进行退出订阅、删除消息、举报消息等管理行为

                                      ③、消息下发时间：  需要通过接口下发消息。

                                      ④、订阅消息模板标题： 最多支持8个字符。

                                      ⑤、订阅消息模板关键词：  最少展示2个关键词，关键词内容最多支持8个字符

                                      ⑥、订阅消息内容：  开发者根据通知场景提供对应的内容，具体下发的消息内容需要审核通过方可下发。

                                      ⑦、用户行动点：    点击可进入开发者自定义的小程序通知页。


                          ★、小程序订阅消息模板按照使用场景划分为 "一次性订阅" 和 "长期订阅"



                          1、一次性订阅：

                                          ①、基础介绍

                                                  一次性订阅更适配服务触达场景，即目的在于跟用户发生交互(如订单)后的服务通知，对应解决开发者当下及时性的服务触达诉求、

                                                  常见一次性消费模板为交易履约类通知：

                                                      △、订单通知

                                                      △、履约通知

                                                      △、航班动态


                                          ②、实时提醒

                                                  部分一次性订阅消息模板支持额外的触达能力----实时提醒能力 (包含端内横幅以及端外 push )

                                                      △、在模板库内选择 "一次性订阅" 在 "额外触达能力" 中展示 "实时提醒" 则支持。

                                                            展示  "未设置"则不支持。 

                                                            长期订阅消息模板不支持申请实时提醒。

                                                            图示：

                                                                  https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/aa6c745a966f47b7a7e17efbef20008d~tplv-goo7wpa0wc-quality:q75.awebp

                                          ③、频次控制
                                            
                                                      △、小程序对于同一用户发送订阅消息频率限制为1条/s.

                                                      △、一次性订阅消息下发频次：

                                                              用户订阅后可向单个用户发送2条消息通知，有效期为1年。

                                                              对应模板的下发频次不满足实际使用需求可提交审核增加，审核时会以实际使用场景合理通知量级评估在不影响用户体验情况下可增加下发频次。

                                                      △、实时提醒能力频控:

                                                              每个用户每个小程序每天仅展示2次。



                          2、长期订阅

                                          ①、基础介绍

                                                      长期 订阅更适配推广运营，即目的更偏向长期的用户复访运营，对应解决开发者长期的推广运营诉求。

                                                      常见长期订阅消息模板未内容互动类通知：

                                                            △、内容更新通知

                                                            △、玩法升级

                                                            △、会员冬天

                                                            △、福利发放

                                                  
                                          ②、信息流通知：

                                                      部分长期订阅消息模板支持额外的触达能力 ---- "信息流通知能力(即订阅异形卡)"

                                                          △、在模板库内 选择 "长期订阅" 在 "额外触达能力"中展示 "信息流通知" 则支持，
                                                            
                                                              展示未设置则不支持：

                                                                  (一次性订阅消息模板不支持申请信息流通知)

                                                                图示：

                                                                     https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6990bf82ff3f45eea5d0743efb7a1568~tplv-goo7wpa0wc-quality:q75.awebp 

                                                          ★、符合以下规范的长期订阅消息模板审核通过后支持信息流通知：

                                                                (1)、支持一下使用场景：   适合用户看到嘻嘻提醒类内容后有访问小程序预期的通知场景。

                                                                       ①、对时效要求低的消息，信息流通知(即异形卡)在遵循时效频控要求的情况下非实时下发，需要用户在抖音刷到对应内容时不会产生违和感。

                                                                       ②、对用户起到提醒的消息，用户通过订阅异形卡提醒进入小程序，可完成后续消费、互动、履约等动作如签到、观看内容等。


                                                                (2)、不支持以下使用场景：  不适合会影响用户体验的消息下发

                                                                      ①、时效要求较高的消息，例如： 订单正在配送，属于需要及时触达用户的内容，

                                                                             如果通过订阅异形卡展现在信息流内，等用户刷到时会存在消息过时的问题。

                                                                      ②、普通通知已满足用户需求的消息，例如： 互动已提交报名，用户通过通知中心
                                                                       
                                                                             即可获取信息非必要进入小程序的内容不适合使用订阅异形卡。


                                          ③、频次控制：  

                                                         △、小程序对于同一用户发送订阅消息频率限制为 1条/s

                                                         △、长期订阅消息下发频次：   用户订阅后每月最多可向单个用户发送8条消息通知。

                                                                    对应模板的下发频次不满足实际使用需求可提交审核增加，审核时会以实际使用场景通知量级评估在不影响用户体验的情况下可以增加下发频次。

                                                         △、信息流通知频控： 

                                                                    用户单天内对用以小程序仅能收到一次订阅消息异形卡提醒 （已授权状态喜爱木人开发者给用户当日下发的第一条订阅消息触发）。

    */

    /*
        五、使用规范


                    1、订阅消息开放原则：  面向在抖音开放平台经营的已上线小程序全量开放。


                    2、订阅消息模板使用及申请原则：  

                              小程序在申请订阅消息模板时需选择对应行业的消息模板，小程序在下发订阅消息时需遵循抖音开放平台规定的频次要求。

                    3、订阅消息清退机制：

                              平台会对订阅率、退订率、点击率和退宿率等数据进行检测，如不符合规范要求，平台将对相关订阅消息进行清退。

                    4、订阅异形卡流量管理：

                              平台会对小程序订阅异形卡的点击率、不感兴趣率、取消订阅率以及3s退出率等数据进行检测，如持续低于上线标准 (点击率 6%，不感兴趣率2%)，

                              将会境地订阅异形卡曝光，请及时优化消息内容并调整发送时机。

                    5、更多订阅消息能力使用规范可查看：

                             "小程序订阅消息能力使用规范" https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/operation/platform-capabilities/subscribe-message/usage-spec
    */

    /*
        六、申请流程：

                   ★、申请位置： 【控制台】---【能力】---【互动能力】---【消息管理】---【订阅消息】

                            图示：

                                  https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ee6300d108b34d34ae3ea50104da78d4~tplv-goo7wpa0wc-quality:q75.awebp


                   ★、申请流程：   

                                 "小程序订阅消息模板申请"  https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/operation/private-account/subscription-message/template-application
                            
                            图示：

                                  https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/64b02b8f54d045278f1bc305fc4dc0aa~tplv-goo7wpa0wc-quality:q75.awebp


                   ★、常见接口文档：

                                  模块名称               接口                                  描述

                              1、公共模板管理        ①、新建订阅消息模板                  当模板库中的公共模板不满足开发者需求时，可以新建公共模板，待审核通过后模板生效。

                                                           https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/create-tpl-v2

                                                    ②、插叙订阅消息模板库                获取小程序所属类目下的公共模板列表

                                                           https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/query-tpl-list-v2

                                                    ③、查询小程序新建的订阅消息模板列表   查询小程序新建的公共模板列表

                                                          https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/query-created-tpl-list-v2

                              2、小程序模板管理

                                                    ①、添加模板                         基于公共模板创建小程序模板

                                                          https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/add-app-tpl-v2

                                                    ②、查询小程序的模板列表              获取当前小程序已添加的小程序模板列表

                                                          https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/query-app-tpl-v2

                                                    ③、删除已添加的模板                  删除已添加的小程序模板

                                                          https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/delete-app-tpl-v2

                              3、消息下发        

                                                    ①、tt.requestSubscribeMessage      调起客户端订阅消息界面，返回用户订阅消息的操作结果。
                                                         (主动拉起授权探查混个)          询问过用户的模板消息会被添加到用户的小程序设置页，，用户可以在设置页面进行管理。

                                                              https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/api/open-interface/subscribe-message/tt-request-subscribe-message
                                                              
                                                    ②、用户订阅动作推送事件              用户订阅模板和拒绝订阅模板时，会推送用户订阅动作时间给开发者

                                                              https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/subscription-status-push-event

                                                    ③、查询用户模板订阅状态              获取当前小程序下用户和小程序模板的订阅状态

                                                              https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/user-template-status

                                                    ④、用户授权订阅卡事件                用户授权长期订阅消息成功且异形卡开关打开情况下，会推送订阅异形卡模板授权成功消息给开发者。

                                                              https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/subscribe-feedcard-webhook

                                                    ⑤、给用户发送订阅消息                用户产生了订阅模板消息的行为后，可以通过该接口发送模板消息给用户。

                                                              https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/subscribe-notification/notify-user-v2

                                                    ⑥、抖音内横幅或抖音外卖实时提醒触达    开发者调用发送订阅消息接口是选择下发抖音内横幅通知货抖音外卖实时提醒通知消息，当横幅或实时提醒消息触达用户失败时，
                                                          用户失败事件                   会推送触达用户失败的事件给开发者。
    */

    /*
        七、常见问题

                  小程序订阅消息创建问题


                  https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/operation/private-account/subscription-message/mini-app-subscription-faq
    */

    /*
        八、应用案例：

                  https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/open-capacity/operation/private-account/subscription-message/subscribe-message                                     
    */
</script>